home *** CD-ROM | disk | FTP | other *** search
/ Aminet 16 / Aminet 16 (1996)(GTI - Schatztruhe)[!][Dec 1996].iso / Aminet / dev / lang / uc_0_30.lha / u / rdocs / r0006.doc < prev    next >
Text File  |  1996-10-30  |  3KB  |  97 lines
  1. **********************
  2. * P R O J E C T  < U >
  3. *
  4. * Author and copyright
  5. * (c) 1996
  6. * Paul van der Valk
  7. *
  8. * file: r0006.doc
  9. * last updated: 30-oct-96
  10.  
  11.  
  12.                       THE UCA2B UTILTY
  13.  
  14.  
  15.  
  16. INTRODUCTION
  17.  
  18. The uca2b utility is a U-Code frontend that translates an ascii
  19. presentation of U-Code into the binary standard. The source format
  20. is quite low level. It's primary use is to create short testcase 
  21. U-Code files. 
  22.  
  23.  
  24. USAGE
  25.  
  26. Command line usage:
  27.    uca2b <srcfile> <dstfile>
  28.  
  29.  
  30. THE UCA2B SOURCECODE
  31.  
  32. A uca2b sourcefile consists of a series of record definitions, one
  33. per line. Blank lines, and comment lines starting with a reverse
  34. single quote (`) may be used.
  35.  
  36. A record is defined by:
  37.  
  38. #rn [>nr] type [%p1] [%%p2] [%%%p3] [arg1 [arg2 [... arg n]]] ["str"]
  39.  
  40. where:
  41.   rn    - the record number.
  42.   nr    - an optianal link to the next record.
  43.   type  - see below.
  44.   %p1   - property-1. Valid range is between 0 and 255. Negative numbers
  45.           may be used as well (i.e: -1 = 255). If ommited then the 
  46.           default value of 0 is used.
  47.   %%p2  - proerty-2. See comment at %p1.
  48.   %%%p3 - proerty-3. See comment at %p1.
  49.   argN  - a 32 bits integer, may be negative.
  50.   str   - a string enclosed in double quotes (").
  51.  
  52. The type field must be supplied and can be one of the following:
  53.  
  54.   .H   Header record. Note that this must be record #1
  55.   .M   Module
  56.   .V   Vardef
  57.   .T   Typedef
  58.   .n   Numeric constant
  59.   .s   String constant
  60.   .c   Function call
  61.   .f   Node call    (not yet fully defined - this may change later on)
  62.   .i   IF
  63.   .w   WHILE
  64.   .u   UNTIL
  65.   .o   FOR          (not yet fully defined - this may change later on)
  66.   .L   Labeldef
  67.   .g   GOTO
  68.   .a   Assignment
  69.   .v   Varref
  70.   .x   Switch       (not yet fully defined - this may change later on)
  71.   ./   Source formatting
  72.   .!   Source comment
  73.  
  74.   @pl  Binary operator: plus
  75.   @mi  Binary operator: minus
  76.   @eq  Binary operator: equal
  77.   @ne  Binary operator: not equal
  78.   @gt  Binary operator: greather than
  79.   @lt  Binary operator: less than
  80.   @ge  Binary operator: greater or equal
  81.   @le  Binary operator: less or equal
  82.  
  83.  
  84. The required arguments depend on the record type. For a listing refer
  85. to the U-Code definition doc (r0005).
  86.  
  87. New for 0.30: uca2b performs a sanity check on the arguments for a given
  88. recordtype. Missing arguments will be substituted with zero values.
  89. Surplus arguments are ignored. If a record requires a string and it
  90. is not supplied by the user then an empty string will be used. String
  91. definitions in string-less records are ignored. This all happends
  92. without any warnings.
  93.  
  94. For some examples sourcecode see the tc????.ua files in the tca
  95. directory.
  96.  
  97.